Custom Controls Component

The Custom Controls component allows you to create a component with various types of Controls that can be used to control other components in your design through use of the Control Pins.

Controls

The available Controls are listed in the Available Controls, and Ranges table under Properties. Their individual functions depend on how you use them. In some cases, the ranges of the Controls can be customized.

Properties

Group 1 - 10

Property

Function

Value

Type

Selects the type of control for the Group.

Initially, there is only one Group visible. When you select a Type for the first Group, a second Group is displayed, and so on until you have 10 Groups.

When you select a Type, Control Pins for each control of that Type, display below the Component in the Schematic, and below the Properties in the Control Pins Section.

See Controls and Ranges table below

Count

Selects the number of controls for the Group. Each Group can have a different Count.

1 to 32

Default range message

Some of the Control Types have variable ranges. This message gives the default range for the specific Control. If there is no range, as with a Toggle Button, there is no message.

See Controls and Ranges table below

Customize range

Specifies if you want to customize the Control's range or not.

No / Yes

Minimum

If you set the Customize Range to Yes, enter the minimum of the desired range.

See Controls and Ranges table below

Maximum

If you set the Customize Range to Yes, enter the maximum of the desired range.

See Controls and Ranges table below

Available Controls, and Ranges

Type

Default/Range

Custom

Minimum

Maximum

Distance knob

(meters)

0 to 100

0

999

Frequency knob

(Hz)

20 to 20000

0.1

20000

Generic float knob

0 to 1

-1,000,000,000

1,000,000,000

Generic integer knob

0 to 1

-2,147,483,648

2,147,483,647

Hexadecimal knob

0x0 to FFFFFF

0

8 bits (24)

LED

Off/On

Level fader w/taper

(dBFS)

-100 to 20

Level knob

(dBFS)

-100 to 20

-100

100

Meter

(dB)

-100 to 20

Momentary button

(Click, hold, release)

Off/On

Mute button

(Toggle)

Off/On

Pan knob

-1 to 1

Percent knob

(%)

0 to 100

0

100

Position knob

0 to 1

Status Display

0 = OK - Green

1 = Compromised - Orange

2 = Fault - Red

3 = Not Present - Gray

4 = Missing - Red

5 = Initializing - Blue

Text display

Text edit

Time knob

(seconds)

0 to 1

0

999

Toggle button

Off/On

Trigger button

(single pulse)

Off/On

<Remove>

(Can only be used on the last in list)

Control Pins

For each Control you select, Input and Output Control Pins are supplied.

When you select a Control Type in the Properties, there are no "selectable" Control Pins in the right-side pane.

NOTE:  The values in the following table are taken at the default setting of the Control.

Pin Name

Value

String

Position

Pins Available

Frequency knob

(Hz)

0 to 25 and Infinity

10 Hz to 20.0 kHz

0.00 to 1.00

Input / Output

Generic float knob

0 to 1

0 to 1.00

0.00 to 1.00

Input / Output

Generic integer knob

0

1

0 or 1

0

1

Input / Output

LED

0

1

false

true

0

1

Input / Output

Level fader

(dBFS)

-100 to 20

-100dB to 20.0dB

0.00 to 1.00

Input / Output

Level knob

(dBFS)

-100 to 20

-100dB to 20.0dB

0.00 to 1.00

Input / Output

Meter

(dB)

-100 to 20

-100dB to 20.0dB

0.000 (-60 dB)

1.000

Input / Output

Momentary button

0

1

false

true

0

1

Input / Output

Mute button

0

1

unmute

mute

0

1

Input / Output

Pan knob

-1 to 1

-1.00 to 1.00

0.00 to 1.00

Input / Output

Percent knob

0 to 1

 

0 to 1

Input / Output

Position knob

0 to 1

0 to 1

Input / Output

Status display

(see below)

0 to 5

OK (Green)

Compromised (Orange)

Fault (Red)

Not Present (Gray)

Missing (Dark Red)

Initializing (Blue)

N/A

Input / Output

Text display

1

text

1

Input / Output

Text edit

2

text

2

Input / Output

Time knob

(seconds)

0.000 to 1.00

0 ms to 1 s

0.000 to 1.00

Input / Output

Toggle button

0

1

false

true

0

1

Input / Output

Trigger button

 

 

 

Input / Output

1. If there is a value/position type input to a Text Display there will be a value, string, and position output as well. If there is a text input, there is no value or position output, only text.
2. If there is a numeric entered, or a value/position type input to a Text Edit box, there will be a value, string, and position output. If there is text entered, or input via the Control Pin, to a Text Edit box, the output is only text.

Status Display Control

The Status Control contains a <state> and a <reason>. The <state> is a number 0-5 inclusive. The <reason> is a string that may be empty. Each <state> has a corresponding <string-representation> and a <color> as follows:

The <color> of the Status Control always tracks the <state> according to the list above.

Getting the Value from a script returns the <state>.

Setting the Value from script sets the <state> and, if the <state> is changed, clears the <reason>.

Getting the String from script does one of 2 things:

Setting the String from script does one of three things:

A result of this behavior is that if you get the <string> of one Status Control and set it to another, both the <state> and <reason> are properly set.

Related Topics Link IconRelated Topics


 

© 2009 - 2016 QSC, LLC. All rights reserved. QSC and the QSC logo are trademarks of QSC, LLC in the U.S. Patent and Trademark office and other countries. All other trademarks are the property of their respective owners.

http://patents.qsc.com.